Informática Multimedia 1995 April

home *** CD-ROM | disk | FTP | other *** search

/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / FILEFIND / SF / SF.DOC next >

Wrap

Text File | 1994-04-23 | 9.3 KB | 310 lines

SuperFind v5.0 (SF) utility (c) David L. Dight, 1993-4. All Rights Reserved. _______ ____|__ | (R) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER ********************************************************* Additional copies and licences can be obtained from: P.O. Box 280, Kings Cross, N.S.W. 2010 AUSTRALIA Phone: +61 2 331 4521, CompuServe: 100033,2563 Please enclose US $9.50 for p/h. ********************************************************* 1. What is SuperFind ? SF is an improved file find utility. Most file finders require the search specification to be passed with each invocation. As each directory is scanned, files are matched with your file spec. SF scans one, more or all drives once only, after which, you simply enter the file spec interactively and SF locates those files. Since SF is interactive, successive finds can be made instantly and without time penalty. File specs can be in the form of a familiar file name or wildcard, or alternatively, a filesize, attribute(s), a date or even a date range. Often when searching for files, you wish to perform some operation on them. Usually you'll have to record the results of a find, create a batch file or some such list and perform those operations. With SF you can specify a command string to execute on each found file. SF substitutes the '$' in your command string with the found file name and then executes the statement. This can be useful in situations like removing all *.BAK files; copying all files in a date range to a diskette; start applications and so on. When SF executes a statement, it firstly swaps itself out of memory, releasing memory for the executing statement. Output from SF can be redirected to a file, printer or COM port from within the program, permitting the creation of file lists. ********************************************************* 2. Running SuperFind usage: SF [-h?apldq] [[d:][directory]...] When SF is run from the DOS prompt with no parameters, all logical drives are scanned by default. You may alternatively specify one or more drives to limit those drives scanned, for example: sf c: a: this may be useful when running SF on a network where scanning all drives may not be desirable. SF automatically detects a drive not ready condition avoiding the annoying DOS error message. You may specify a specific directory to scan, for example: sf \c700 d:\source Any number of drives or directories can be specified. SF accepts a number of other switchable parameters, described below... -h Prints the usage and switch summary. -? Prints the usage message only. -a Specifies to search all drives (default). -p When SF executes a file spec, a pause message is generated. The -p switch suppresses the pause message. This is useful on multi-file operations like copy or delete. -l<n> Specifes 'n' lines per page when listing files (default 24 lines). For example: sf c: -l43 scans the c: drive; when listing SF will use 43 lines per page. -d<n> Specifes 'n' entries per directory scanned. (default 1024 entries). sf -n256 SF will limit itself to 256 entries per directory (useful to save memory). -q Suppress verbose drive scan display. ********************************************************* 3. SuperFind Commands Commands are entered at the ':' prompt after startup. These are as follows... N - Search for a file name or wildcard specification. Any valid DOS file name or wildcard is acceptable, for example: :fd??mu?.* A - Specify one or more attributes to search for. These are: Token Attribute Value A Archive 0x20 D Sub directory 0x10 V Volume ID 0x08 S System 0x04 H Hidden 0x02 R Read Only 0x01 N Normal 0x00 for example (lower case OK): :ash will search for files having the bits 'ASH' set, so that a file with 'ASHR' would also be matched and 'ASR' would not, and :va will search for volume id's with the archive bit set. Files with no attributes at all can be searched by specifying :n for 'no' attribuites. D - Specify a a date and or time, or a date range. SF will respond with: Select <,=,> or R)ange: where... < match files with datestamps less than or equal to a specified date. > match files with datestamps greater than or equal to a specified date. = match files with an exact datestamp. R matches file within an inclusive date range. SF will then prompt you to enter a date or date range. You may also specify a time value which will cause SF to look at file timestamps as well. S - Specify a file size to search for. E - Execute a command string for matching files. SF will prompt: Enter command to execute ($=substituted file): Enter a DOS command line. You should insert the '$' character in the position you want the matched file to be substituted. For example: xcopy $ a:\backup SF will then prompt you to enter... N)ame S)ize A)ttribute D)ate: which are described above. If you entered the above command, with the file spec set to D*.EXE, SF would execute the following commands on each find, for example: xcopy c:\dos\DEBUG.EXE a:\backup xcopy c:\dos\DEFRAG.EXE a:\backup xcopy c:\dos\DELTREE.EXE a:\backup xcopy c:\dos\DOSSWAP.EXE a:\backup . . . After each command is executed, SF will pause, allowing you to view output (press any key) or terminate successive executions (press 'q'). L - Causes SF to list every file that has been scanned. SF will pause between each page. O - Specify the default output stream for printing matched file names or listings. Valid devices are CON, PRN, COM. You may also specify a file name to redirect output to. With no parameters, this command resets the default output to CON. SF will still pause between pages. To force SF to list files continuously, set the page length switch to 0, e.g.: sf -l0 Q - Quit. R - Force SF to rescan all directories. This is useful if you have already executed commands that have altered the contents of directory(s). e.g. deletion or creation of files. * - Print a brief message giving details on distribution, site licences and donations. ! - Invoke a DOS shell. SF will swap itself out of memory to free all system memory to the shell. ? - Get Help on commands ********************************************************* 4. Entry listings When SF locates file(s) it produces a directory style listing in the following format: C:\BIN SF.EXE 77756 A 23-04-94 18:41:20 The directory in which the file is located is printed on a separate line. The next line consists of the full filename; the file size in bytes; the file attribute, where A=archive, S=system, H=hidden, D=directory, V=Volume, N=Normal, R=read-only; the date and time of last write. Sub-directory entries will show the total size in bytes of all entries in the directory. ********************************************************* 5. Disclaimer SF v5.0 IS SUPPLIED AS IS. THE AUTHOR DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE. THE AUTHOR ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF SF v5.0. GOOD DATA PROCESSING PROCEDURE DICTATES THAT ANY PROGRAM BE THOROUGHLY TESTED WITH NON-CRITICAL DATA BEFORE RELYING ON IT. THE USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM.